home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Night Owl 6
/
Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso
/
001a
/
css10.zip
/
CSS.DOC
next >
Wrap
Text File
|
1991-01-24
|
23KB
|
639 lines
▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄
▒▒█▀▀▀▀ ▒▒█▀▀▀▀ ▒▒█▀▀▀▀
▒▒█ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄
▒▒█ ▀▀▀▒▒█ ▀▀▀▒▒█
▒▒▒▒▒▒▄ ▒▒▒▒▒▒█ ▒▒▒▒▒▒█
▀▀▀▀▀▀ ▀▀▀▀▀▀ ▀▀▀▀▀▀
CSS - The SIMPLE Language PreProcessor for Telix
Version 1.0 Date: January 24th, 1991
Copyright 1991, by Host Software Products
Host Software Products
15837 Windrose Way
San Diego, CA 92127-2066
Daniel E. Horn - President
Page: 1
WHAT IS CSS?
CSS is a full scale PreProcessor for the SALT (Script Application
Language for Telix) and provides a easy to use and understand
language called SIMPLE. CSS compiles directly into SALT and then
automatically compiles the SALT script by running the CS program
provided with the Telix (C) communications program. CSS allows
the user to write scripts using the SIMPLE language that are
fully compatible and executable under the Telix program, but are
easy to write and are completely understandable.
The SIMPLE language has been written with the base user in mind,
it is a language which is based upon the english sentence
structure and who's functions are named in accordance to their
operations. This provides a language that is easily remembered
and simple to work with.
Page: 2
This program is distributed under the Shareware concept Non-
Registered users of CSS are granted a limited license to use it
for a 4 week trial period, in order to determine it's usefulness
to you. ANY other use of CSS after that period is strictly
prohibited.
WHY REGISTER?
* Registration allows you to use CSS on a regular basis.
* Registered users will receive mailed notification of updates
to the program.
* Registered users will also receive top priority in any help
or comments they have/need.
* Registered users receive copies of the program which have
the register comment removed, as well as the compile message
and delay compiled into the resulting script.
* The registered version also contains the ability to save the
resulting SALT file to disk so as to view it's contents, as
well resulting SIMPLE scripts compiled will no longer have
the notification delay in running.
* Registered users will be able to join the beta test process,
and will receive previous of all new software if they want.
Registration is US$20.00 plus US$2.50 (US$3.50 OverSeas) for
shipping and handling and covers all of the above features.
To Order, Make check or money order out to:
Host Software Products
15837 Windrose Way
San Diego, CA 92127-2066 USA
Page: 3
-----------------------------------------------------------------
Please Send:
CSS 1.0 Registration....................... US $20.00 _____
Shipping and Handling include US $2.50 (US $3.50 Overseas)
Disk Size: 5.25" _____ 3.5" _____
{ Please Print }
Name :_________________________________________________________
Address:_________________________________________________________
_________________________________________________________
_________________________________________________________
Day Phone: (____)_____-______ Evening: (____)_____-______
Comments:________________________________________________________
________________________________________________________
________________________________________________________
{ Optional }
Computer Type:___________________________________________________
Color Display [Y/N]: ___
Where did you hear about (and/or receive a copy of) CSS?
{ } BBS Name ________________________ Ph #(____)_____-______
{ } Sig Name _______________________________________________
{ } CompuServe
{ } Friend
{ } Other: _________________________________________________
_________________________________________________________________
Page: 4
This program evolved from an idea from talking to and
hearing complaints from people who felt that the SALT language
was to difficult to use, to hard to remember, to "Big" for those
tiny little scripts. It was written originally as a project to
test out a theory of mine and eventually was expanded to it's
current abilities. CSS is an ongoing project and will continue
to be worked and expanded as time goes by.
DISCLAIMER
This program is provided as is, and is to be run at your own
risk. There is NO warranty of any kind or form covering this
program. Exis, Inc, Colin Sampaleanu, and Host Software Products
are not in any way responsible, or liable for any damages of any
kind that may arise from the usage of this program, or that of
any program or files associated, or included with it.
TELIX.EXE, CS.EXE, SALT: Copyright 1986, 1987, 1988, 1989, 1990,
1991, by Exis Inc., and Colin Sampaleanu.
Used with permission.
Page: 5
USING CSS
Before you can run a SIMPLE script file you must first compile
the script using CSS, CSS accepts a single filename on the
command line with a default extension of 'SIM', and will then
process the file into the SALT language, if there are any error's
encountered during the compilation CSS will report them and halt
the process. Following is an example of how to invoke CSS with
the filename of LOGON.
CSS logon
CSS will attempt to compile the SIMPLE script and if successful
will automatically run CS.EXE. If CS.EXE can not be found, or
there was not enough memory to run CS.EXE then CSS will abort the
process with the appropriate error. CS.EXE should be placed
someplace in your PATH statement so that CSS can find it.
Optionally the use of the Environment variable CS can be placed
in the environment as follows:
CS=C:\TELIX\SCRIPTS
Where "C:\TELIX\SCRIPTS" is the full path where CS.EXE resides.
This is useful if you keep CS.EXE in a directory that is not in
your path.
Page: 6
THE SIMPLE LANGUAGE
The SIMPLE (Salt Implementation) language is a easy to use
language made up of functions which are named according to their
operations, the SIMPLE language is compiled directly into SALT
via CSS and then compiled into a script using CS (run
automatically by CSS). The language has been written with the
novice user in mind and should be fairly easy to use, following
is a list of all functions currently supported by CSS and the
SIMPLE specifications and a description of each of those
functions. The SIMPLE language script is designed to have a
single function on each line of the file, in certain cases there
are multiple functions (as in the case of a WAITFOR or WHENEVER
statement) on a single line.
NOTATION
Throughout the following pages, certain words in the text are
notated by <expression> or [expression]. Any words in standard
brackets are entirely optional statements and are not required by
CSS to be included in the statement for compilation. Expressions
such as <Integer> are to be replaced with an actual integer (from
-32,000 to +32,000) in the code and should not be placed in the
actual script. Words such as <Sx> are string expressions and
should be replaced with either a string constant (ie group of
words in quotations, such as "This is a string") or a string
variable of the type STRINGxx where 'xx' is a number from 1 to
16, for example the string variable STRING3 is valid while
STRING17 is not.
-----------------------------------------------------------------
ALARM <Integer>
Causes an alarm to be rang of up to <Integer> seconds.
Example:
ALARM 2
-----------------------------------------------------------------
WAIT <Integer>
Causes the script to wait for up to <Integer> seconds.
Example:
WAIT 10
Page: 7
_________________________________________________________________
SEND <Sx> [HITENTER]
Sends the string <Sx> to the remote system, optional HITENTER can
be placed following the string and SEND will add a Carriage
Return (ie as if you pressed ENTER) at the end of the string.
Note that you can leave <Sx> out and just do SEND HITENTER and
only a Carriage Return will be sent.
Example:
SEND "John Smith" HITENTER
_________________________________________________________________
SHELL
Do a Shell to DOS (Same thing as pressing ALT-J from within
Telix).
Example:
SHELL
_________________________________________________________________
SAVESCREEN
Capture the current screen to disk, stored in the default image
file. (Same as pressing ALT-I from within Telix).
Example:
SAVESCREEN
_________________________________________________________________
SOUND <Integer1>, <Integer2>
Causes a sound of <Integer1> tone for a duration of <Integer2>
seconds.
Example:
SOUND 20, 10
_________________________________________________________________
HANGUP
Causes Telix to hangup the phone. (Same as pressing ALT-H from
within Telix).
Example:
HANGUP
Page: 8
_________________________________________________________________
MESSAGE <Sx>
Prints the string <Sx> on the screen surrounded by a box for 30
seconds.
Example:
MESSAGE "Connected to BBS"
_________________________________________________________________
PRINTER (ON/OFF)
Turns the Printer capture ON or OFF depending on which switch is
used. (Same as pressing Ctrl-@ from within Telix).
Example:
PRINTER ON
_________________________________________________________________
TIME <Sx>
Places the current time into the string variable <Sx>. Note that
<Sx> *MUST* be a string variable of STRING1 - STRING16.
Example:
TIME STRING2
_________________________________________________________________
DATE <Sx>
Places the current date into the string variable <Sx>. Note that
<Sx> *MUST* be a string variable of STRING1 - STRING16.
Example:
DATE STRING11
_________________________________________________________________
INPUT <Sx>, <Integer>
Get's up to <Integer> characters from the keyboard and places
them into the string variable <Sx>. Note that <Sx> *MUST* be a
string variable of STRING1 - STRING16.
Example:
INPUT STRING7, 20
Page: 9
_________________________________________________________________
SHOW <Sx> [HITENTER]
Prints the string <Sx> to the screen, optional HITENTER can be
placed following the string and SHOW will add a Carriage Return
(ie as if you pressed ENTER) at the end of the string. Note that
you can leave <Sx> out and just do SHOW HITENTER and only a
Carriage Return will be printed.
Example:
SHOW "Hello" HITENTER
_________________________________________________________________
ASSIGN <Sx1>, <Sx2>
Assign the string <Sx2> to the string variable <Sx1>. Note that
<Sx1> *MUST* be a string variable of STRING1 - STRING16.
Example:
ASSIGN STRING1, "John Smith"
_________________________________________________________________
UPLOAD <Sx> [WITH <Protocol>]
Uploads string filename <Sx> to the remote system (note that <Sx>
must be a valid filename), optional WITH <Protocol> can be added
to the end and the upload will be made with the defined
<Protocol>. Note that <Protocol> *MUST* be a valid protocol
name, if it is not Telix will prompt you for the protocol when
you attempt the upload.
Examples:
UPLOAD "TEST.ZIP"
UPLOAD "FILELIST.ZIP" WITH Zmodem
_________________________________________________________________
DOWNLOAD <Sx> [WITH <Protocol>]
Downloads string filename <Sx> from the remote system, optional
WITH <Protocol> can be added to the end and the download will be
made with the defined <Protocol>. Note that <Protocol> *MUST* be
a valid protocol name, if it is not Telix will prompt you for the
protocol when you attempt the download.
Examples:
DOWNLOAD "NEWFILES.ZIP"
DOWNLOAD "TELIX1.ZIP" WITH Xmodem
Page: 10
_________________________________________________________________
WAITFOR <Sx> [MAXOF <Integer>] THENDO <Command>
Waits for the string <Sx> from the com port for an optional
<Integer> number of seconds (If no MAXOF <Integer> is given a
default of 30 seconds is used). If the string <Sx> is received
then the <Command> (following THENDO) is processed. Note that
<Command> can be any of the command functions in SIMPLE with the
exception of another WAITFOR or any of the WHEN commands).
Examples:
WAITFOR "First Name: " THENDO SEND "John" HITENTER
WAITFOR "Download: " MAXOF 50 THENDO SEND "NEWFILES.ZIP" HITENTER
_________________________________________________________________
DIAL <Sx> [FROM <Sx>] [MAXOF <Integer>]
Dial's the numbers in the string <Sx> (format of number space
number etc, ie "1 2 3"), optional FROM <Sx> allows you to specify
the phone directory (string <Sx>) to dial from, if FROM <Sx> is
not given then it will dial from the current dialing directory.
Optional MAXOF <Integer> allows you to specify the total number
of dialing attempts before quitting, if MAXOF <Integer> is not
given then it will dial until a connection has been established.
Examples:
DIAL "1 5 2" MAXOF 30
DIAL "6 13" FROM "INSTATE.FON"
_________________________________________________________________
BBSPASSWORD
This constant contains (When a dial has been established) the
password defined for the dialing directory entry. It can be used
with the functions SHOW, SEND, MESSAGE, and ASSIGN. The most
common use would be with SEND in order to send your password to
the remote system.
Example:
WAITFOR "Password: " THENDO SEND BBSPASSWORD HITENTER
Where Telix would wait for the string of "Password: " and then
would send the password defined in the dialing directory and then
press enter.
Page: 11
_________________________________________________________________
RUNSCRIPT <Sx>
This will run the script name <Sx>, note that the string <Sx>
must contain a valid script name.
Example:
RUNSCRIPT "LOGON.SLC"
_________________________________________________________________
DOS <Sx> [PAUSESCREEN]
Run's the command given in the string <Sx> in DOS, optional
PAUSESCREEN will cause the screen to pause once the command has
been run and will wait for a key to be pressed.
Example:
DOS "DIR /W" PAUSESCREEN
_________________________________________________________________
STARTWHEN
Starts a WHENEVER loop, all commands following STARTWHEN must be
WHENEVER commands until a following ENDWHEN command is given.
Example:
STARTWHEN
WHENEVER "First" THENDO SEND STRING2 HITENTER
ENDWHEN
-----------------------------------------------------------------
WHENEVER <Sx> THENDO <Command>/<QUITWHEN>
Continues to wait for the string <Sx>, once the string <Sx> has
been received then the command <Command> is executed, the
<Command> can be any of the SIMPLE functions with the exception
of WAITFOR. If the <Command> is QUITWHEN then the STARTWHEN loop
is aborted and process is continued after the ENDWHEN. Note that
if none of the WHENEVER's within a STARTWHEN loop have the
command of QUITWHEN then the *LAST* WHENEVER is assumed to be the
final one and the loop will finish after that string has been
processed.
Example:
STARTWHEN
WHENEVER "First" THENDO SEND "John" HITENTER
WHENEVER "Last" THENDO SEND "Smith" HITENTER
ENDWHEN
Page: 12
-----------------------------------------------------------------
ENDWHEN
Ends the WHENEVER loop, must be placed after a STARTWHEN and only
WHENEVER statements (Up to 12) can be placed in between STARTWHEN
and ENDWHEN.
-----------------------------------------------------------------
Page: 13
WHAT'S AHEAD IN THE FUTURE?
About the only thing we can say is 'More Functions'. We
will continue adding new functions and abilities to both the
SIMPLE language and to CSS.
THANKS AND APPRECIATION
Much thanks and appreciation goes to Jeff Woods who has
helped me with the layout and format of the SIMPLE language as
well as providing encouragement and lot's of good idea's. The
original idea started out as a off the wall discussion between
Jeff and myself.
I can't thank you enough Jeff!
And of course as always goes thanks to Colin Sampaleanu, for
all the hard work and effort he has put into Telix and SALT,
without which all of this work would be worthless!
Thanks once again Colin!
Page: 14
REGUARDING DOCS
We are always looking for people who are good at writing
documentation. If you feel you can do a better job, then please
do so and give us the end result, we will take all applications
and choose the one we feel is best. If your's is the one choosen
you will receive a free registration to CSS (or upgrade if you're
already registered) and you will receive mention in our docs!
TECHNICAL SUPPORT
If you have any bugs, comments, or suggestions for us on CSS
please let us know. You can reach us in the following ways:
BEST WAY!-> PCRelay (RIME), HOST-BBS Conference
If your PCRelay Board does not carry our support
conference ask them to! Ask for:
HOST-BBS - RelayNet Master Number #203
Telix Support BBS, (416) 439-9399
PCRelay (RIME), Telix Conference
FIDO Net, Telix Conference
InterLink, Telix Conference
Call us voice at: (619) 674-1549
Business Hours: Mon-Fri 10am-5pm Pacific Time
Or write us at:
Host Software Products
15837 Windrose Way
San Diego, CA 92127-2066 USA